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The Berkeley Sockets API 


e Widely used low-level C networking API 


@ First introduced in 4.3BSD Unix 


@ Now available on most platforms: Linux, MacOS X, 
Windows, FreeBSD, Solaris, etc. 


e Largely compatible cross-platform 


Concepts 


@ Sockets provide a standard 
interface between network 
and application 


@ Two types of socket: 
@ Stream — provides a virtual circuit service 


e Datagram — delivers individual packets 


e@ Independent of network type: 


@ Commonly used with TCP/IP and UDP/IP 
but not specific to the Internet protocols 


@ Only discuss TCP/IP sockets today 


TCP/IP Connection 


int fd = socket(...) 


connect(fd, ..., ...) 
write(fd, data, datalen) 


read(fd, buffer, buflen) 


close(fd) 


int fd = socket(...) 


band(fd; «avy ose) 
Listen(fdy. s««) 
connfd = accept(fd, ...) 


read(connfd, buffer, buflen) 


write(connfd, data, datalen) 


close(connfd) 


TCP/IP Connection 


Server fd = socket (..);_ 


Client bind ( £O 5.2 )s | Specify well-known port 
fd = socket (...); listen(fd, ie ‘Begin listening 
met 
connect (fd, =) : pad = accept(fd, 

es aa © F Block unt connection esabished 
geen Saas aE IEEE ! Send request (Gk) EE 

write(fd, aa) . Peer re reir i rir ttt ttt ett > read(connfd, 


Wait for response 


TCP/IP connection shutdown 
close(fd, mee PPP Pee eer reer reer rrrrrerrrrrrrrrrt rer > read(connfd, 


Creating a socket 


#include <sys/types.h> | 


pauses Ssi/e)/ Slee seit] aE INEE Tonle 


Se en nce _ AF_INET6 for IPvé6 
plone ely 


SOCK STREAM for TCP 
SOCK DGRAM for UDP 


fd = socket (family, 
if (fd == -1) { 
// Error: unable to create socket 


type, protocol) ; 


0 (not used for Internet sockets) 


Create an unbound socket, not connected to network; 
can be used as either a client or a server 


Handling Errors 


Socket functions return —1 and set the global 
variable errno on failure 


fd = socket(family, type, protocol) ; The Unix man pages should 


A CE a iy a 
PP eaieee aeernon & | list the possible errors that 
case EPROTONOTSUPPORT : can occur for each function 
// Protocol not supported 
case EACCESS: Eg.do“man socket” and 
// Permission denied = see the ERRORS section 
default: | 


// Other error... 


Binding a Server Socket 


: Bind a socket toa port #include <sys/types.h> 
on anetwork interface  #include <sys/socket.h> 


@ Needed to run servers on a well- if (bind(fd, addr, addrlen) == -1) a 
known port | // Error: unable to bind : 


@ Not generally used on clients, 
since typically don’t care which 
port used be ph here rhe eat oan acme canter arta week Tete Trent 


Listening for Connections 


#include <sys/types.h> | 
#include <sys/socket.h> 


// Error : 


Tell the socket to listen for new connections 


The backlog is the maximum number of connections the 
socket will queue up, each waiting to be accept ( )’ed 


Connecting to a Server 


#include <sys/types.h> | 
#include <sys/socket.h> 


Pointer toa struct sockaddr 


Size of the struct in bytes 


if (connect(fd, addr, addrlen) == -1) { | 
// Error: unable to open connection 


Tries to open a connection to the server 
Times out after 75 seconds if no response 


Specifying Addresses & Ports 


@ Must specify the address and port when calling 
bind() or connect( ) 


@ The address can be either IPv4 or IPv6 


@ Could be modelled in C as a union, but the designers 
of the sockets API chose to use a number of structs, 
and abuse casting instead 


struct sockaddr 


e Addresses specified using 
struct sockaddr 


@ Has a data field big enough to hold struct sockaddr { 


the largest address of any family uint8_t sa_len; 
: sa family t sa_family; | 
e Plus sa_lenandsa_family to. char sa_data[22];. 
specify the length and type of the}, 
address See arencereaeaee ence nee nee near e nee eee P nae RTT eee NTR Ree ee eee TaN eT RT eer 


e Treats the address as an opaque 
binary string 


struct sockaddr in 


@ Two variations exist for 
IPv4 and IPv6 addresses 


Use struct sockaddr _in 
to hold an IPv4 address 


Has the same size and memory 
layout as Struct sockaddr, 
but interprets the bits differently 
to give structure to the address 


struct in_addr { 
in addr t s addr; 


struct sockaddr _in { 


uint8 t Sin len; 

sa family t Sin family; 
in port t Sin port; 
struct in addr sin addr; 
char sin pad[16]; 
4; 


struct sockaddr in6 


@ Two variations exist for 
IPv4 and IPv6 addresses 


Use struct sockaddr _in6 
to hold an IPv6 address 


Has the same size and memory 
layout as Struct sockaddr, 
but interprets the bits differently 
to give structure to the address 


struct in6 addr { 
: uints t s6 addr[16]; 
ae 


struct sockaddr _in6é { 


uints8 t sin6 len; 

: sa_family t sin6é family; 

in port t Sin6é port; 
: uint32 t sin6 flowinfo;. 
: struct in6 addr siné addr; 
di 


Working with Addresses 


@ Work with either struct sockaddr inor 
struct sockaddr _ in6 


e Cast ittoa struct sockaddr before calling 
the socket routines 


struct sockaddr in addr; 
// Fill in addr here 


if (bind(fd, (struct sockaddr *) &addr, sizeof(addr)) == -1) { 


Creating an Address: Manually 


ease 
#include <sys/socket.h> Inet _pton() to convert address 


#include <netinet/in-h> htongs() to convert port 
#include <arpa/inet.h> | 


istruct sockaddr_in addr; 

inet_pton(AF_INET, “130.209.240.1", &addr.sin_addr) ; 
addr.sin_family = AF_INET; 

addr.sin_port = htons(80); 


if (connect(fd, (struct sockaddr *)&addr, sizeof(addr)) == -1) { 


Creating an Address: DNS 


@ Prefer using DNS names to raw IP addresses 


e Use getaddrinfo() to look-up name in the DNS 


@ Returns a linked list of struct addrinfo values, 
representing the addresses of the host 


struct addrinfo { 


int ai_flags; // input flags 

int ai family; // AF_INET, AF_INET6, ... 

int ai_socktype; // IPPROTO TCP, IPPROTO UDP 
int ai_ protocol; // SOCK STREAM, SOCK DRAM, ... 
socklen_t ai_addrlen; // length of socket-address 
struct sockaddr *ai_addr; // socket-address for socket 
char *ai_canonname; // canonical name of host 
struct addrinfo *ai_next; // pointer to next in list 

22 


Connecting via a DNS Query 


struct addrinfo hints, *ai, *ai0; 


memset (&hints, 0, sizeof(hints)); 

hints.ai_family = PF _UNSPEC; 

hints.ai_socktype = SOCK STREAM; 

alse ((i = getaddrinfo(“www.google.com”, "80", &hints, &ai0)) != 0) { 
printf("Unable to look up IP address: %s", gai_strerror(i)); 


for (ai = aid; ai != NULL; ai = ai->ai_next) { 
fd = socket(ai->ai_family, ai->ai_socktype, ai->ai_protocol); 
if (fd == =1) { 

perror("Unable to create socket"); 

continue; 


} 


if (connect(fd, ai->ai_addr, ai->ai_addrlen) == -1) { 
perror("Unable to connect"); 
close(fd); 
continue; 


Accepting Connections 


#include <sys/socket.h> 


int connfd; 
struct sockaddr_in cliaddr; 
socklen_t cliaddrlen = sizeof(cliaddr); 


connfd = accept(fd, &cliaddr, &cliaddrlen); 
if (connfd == -1) { 
/ BEBO 


Accept a connection, returning a new file descriptor for that 
connection (connfd) and the client’s address (cliaddr) 


Accepting Connections 


@ ATCP/IP server may have multiple connections 
outstanding 
@ Can accept () connections one at a time, handling 
each request in series 


@e Can accept() connections and start a new thread 
for each, allowing it to process several in parallel 


@ Each call to accept() returns a new file 
descriptor for the new connection 


Reading and Writing Data 


#define BUFLEN 1500 


Issize_t ds 
ssize_t recount; 
ichar buf [ BUFLEN]; 


rcount = read(fd, buf, BUFLEN) ; 


if (rcount == -1l) { 
// Error has occurred 


for (i = 0; i < recount; i++) { 
DEIMet (“4e",, butla])- 


Read up to BUFLEN bytes of 
data from connection. Blocks 
until data available to read. 


Returns actual number of bytes 


read, or -1 on error. 


| Data read from the connection 
is not null terminated. 


Reading and Writing Data 


Keereopeocrcd _ What gets printed? 


#include <string.h> 


int main( ) 


char x[] "Hello, world!"; 
char *y = malloc(14); 


sprintf(y, "Hello, world!"); 


pPrintti("x = ¢e\n";. x); 
printf("y = s\n", vy): 


printf("sizeof(x) = d\n", SRSA) py Why? 


printt(“sizeot(y) = d\n", sizeot(y)); : 


print£("strlen(x) = @d\n", strlen(x));_ 
printf("strlen(y) = d\n", strlen(y));. 


return 0; 


Reading and Writing Data 


char data = “Hello, world!”; 
int datalen = strlen(data); 


if (write(fd, data, datalen) == -1) {| 
// Error has occurred 


Send data on a TCP/IP connection. Blocks until 
all data can be written. 


Returns actual number of bytes written, or -1 
on error. 


Closing a Socket 


Close and destroy a socket 


Close the file descriptor for each 
connection, then the file descriptor for 
the underlying socket 


Questions? 


